home *** CD-ROM | disk | FTP | other *** search
/ The Very Best of Atari Inside / The Very Best of Atari Inside 1.iso / sharew / accs / xdir / xdir.doc < prev   
Encoding:
Text File  |  1986-02-05  |  7.8 KB  |  181 lines
  1.  
  2.  
  3.                               XDIR.ACC / XDIR.PRG
  4.                                      V 4.5
  5.  
  6.                          (C) Klaus Rittmeier,  3/1990
  7.  
  8.  
  9.  
  10.  Dieses Programm ist als Ergänzung zum normalen GEM-Desktop gedacht.
  11.  Neben einigen Grundfunktionen des Desktop ( Anzeige, Ausdrucken, Umbenennen
  12.  von Dateien ) stellt es einige nützliche Zusatzfunktionen zur Verfügung :
  13.  
  14.  * Anzeige der vollständigen Belegung von Subdirectories,
  15.  * Umbenennen von Ordnern,
  16.  * Anlegen und Umbenennen von volume labels,
  17.  * Setzen und Löschen von Dateiattributen,
  18.  * Aktualisierung des Zeiteintrages einer Datei,
  19.  * Anzeige und Ausdrucken von Dateien als Hexdump,
  20.  * Verschieben von Dateien und Subdirectories zwischen verschiedenen
  21.    Verzeichnissen eines Laufwerkes.
  22.  
  23.  
  24.  Durch Ändern der Extension im Dateinamen ist es möglich, das Programm sowohl
  25.  als Accessory (XDIR.ACC), als auch als normale Applikation (XDIR.PRG) zu
  26.  starten.
  27.  
  28.  Der Speicherbedarf beträgt ca. 38 kByte.
  29.  
  30.  
  31.  Ab Version 4.31:
  32.  * Nach dem Start erscheint das Directory des aktuellen Laufwerkes, nicht
  33.    des Laufwerkes A.
  34.  * Für die Eintragungen im volume label, Ordner- oder Dateinamen sind
  35.    nun alle Zeichen zugelassen. ( Groß-, Kleinbuchstaben, Ziffern, Sonder-
  36.    zeichen )
  37.  
  38.  
  39.  
  40.  Ein Aufruf des Accessories ( Menüeintrag 'Directory' ) bzw. der Start des
  41.  Programms vom Desktop bringt ein Fenster ähnlich einem Desktop-Fenster auf
  42.  den Bildschirm. Das Fensterhandling ( Verschieben, Scrollen, Größenverän-
  43.  derung ) ist analog dem des GEM-Desktops.
  44.  Ein zweites Fenster mit gleichem Inhalt kann durch Eingabe der Laufwerks-
  45.  kennung ( Kleinbuchstaben a ... ) über die Tastatur geöffnet werden.
  46.  Achtung: Verwechseln Sie diese Fenster nicht mit den Desktop-Fenstern !
  47.  Sie erkennen die Fenster dieses Programms am fehlenden "FULLER" in der
  48.  rechten oberen Ecke des Fensters.
  49.  
  50.  
  51.  Die Kopfzeile der Fenster zeigt den kompletten Pfadnamen des jeweiligen
  52.  Verzeichnisses.
  53.  In der Infozeile wird die effektive Belegung des Verzeichnisses angezeigt.
  54.  Jeder auch nur teilweise belegte Cluster wird dabei mit 1024 Bytes als voll
  55.  belegt gerechnet.
  56.  Das erleichtert die Einschätzung des benötigten Diskplatzes beim Kopieren.
  57.  
  58.  
  59.  Ein Doppelklick auf eine Zeile zeigt je nach Art des Eintrages eine Dialog-
  60.  box, die folgende Aktivitäten ermöglicht :
  61.  
  62.    volumelabel : Umbenennen.
  63.                  Steht in der ersten Zeile der Satz 'Diskette hat kein volume
  64.                  label, so ermöglicht ein Doppelklick auf diese Zeile das
  65.                  nachträgliche Anlegen eine volume labels.
  66.  
  67.    Ordner      : Umbenennen,
  68.                  Öffnen.
  69.  
  70.    Datei       : Umbenennen,
  71.                  Löschen,
  72.                  Zeiteintrag aktualisieren ( touch ),
  73.                  Setzen / Löschen der Attribute readonly, hidden, system,
  74.                  archive.
  75.                  Anzeigen des Dateiinhaltes als Listing oder Hexdump.
  76.                  Wahlweise kann die Ausgabe auf den Drucker oder auf den
  77.                  Bildschirm erfolgen.
  78.                  Bei Ausgabe auf den Bildschirm kann mit der Leertaste
  79.                  weitergeblättert werden. 'Return' bewirkt einen Zeilenvor-
  80.                  schub, 'q' beendet die Anzeige.
  81.  
  82.  Die beiden Dialoge "Disk-Info" und "Ordner-Info" zeigen auch die effektive
  83.  Gesamtbelegung der Diskette bzw. des Verzeichnisses. Auch hier werden alle
  84.  Cluster als voll belegt gerechnet.
  85.  
  86.  Wird beim Doppelklick auf einen Ordner-Eintrag die linke Shift-Taste nieder-
  87.  gehalten, so wird der Ordner gleich geöffnet, der Dialog erscheint dann nicht.
  88.  
  89.  Ein Anklicken des Schließfeldes eines Fensters hat die gleiche Wirkung wie
  90.  beim GEM-Desktop : Verzeichnis schließen, im Dateibaum eine Stufe nach oben
  91.  gehen. Befindet man sich in der Wurzel, wird das Fenster geschlossen.
  92.  Sind beide Fenster geschlossen, so wird das Programm verlassen.
  93.  
  94.  
  95.  
  96.  Eine Besonderheit des Programms ist die Kopieroperation. Eigentlich handelt
  97.  es sich dabei nicht um ein physisches Kopieren, sondern lediglich um eine
  98.  Änderung des Directory-Eintrages in einem Verzeichnis. Dadurch ist es möglich,
  99.  selbst auf voll belegten Disketten Dateien oder ganze Ordner samt Inhalt
  100.  zu verschieben. Selbstverständlich funktioniert das nicht zwischen verschie-
  101.  denen Laufwerken. Das ist der Grund dafür, daß beide Fenster immer
  102.  Verzeichnisse desselben Laufwerkes enthalten.
  103.  
  104.  
  105.  Wie funktioniert nun das 'logische Kopieren' ?
  106.  
  107.  Genau wie beim GEM-Desktop klicken Sie den gewünschten Eintrag ( Ordner oder
  108.  Datei ) an, halten die linke Maustaste gedrückt und schieben den Mauscursor
  109.  über das geöffnete Fenster des Zielverzeichnisses.
  110.  Mehrere Directoryeinträge können Sie selektieren, indem Sie beim Anklicken
  111.  der Einträge die linke Shift-Taste gedrückt halten.
  112.  Das Selektieren mehrerer Einträge durch Einrahmen mit einer "Gummibox" ist
  113.  nicht (!) möglich.
  114.  
  115.  Sie haben dann in einer Alertbox noch die Möglichkeit des Abbruchs der Ope-
  116.  ration.
  117.  Wählen Sie jedoch 'OK', so wechseln die gewählten Dateien und Ordner samt
  118.  Inhalt in Sekundenschnelle das Verzeichnis.
  119.  
  120.  Es gibt jedoch einige Einschränkungen, die ein solches "Kopieren" verbieten:
  121.  
  122.  1. Ein Ordner darf nicht in sich selbst kopiert werden.
  123.  2. Er darf auch nicht in ein Unterverzeichnis, das sich auf einem Zweig von
  124.     sich selbst befindet ( 'Ordner im Ordner des Ordners...' ) verschoben
  125.     werden.
  126.  3. Dieses Programm allociert keine neuen Cluster für ein Verzeichnis. Deshalb
  127.     funktioniert das 'Kopieren' auch nicht, wenn ein Verzeichnis bereits
  128.     einen Cluster voll belegt.
  129.     Mit einem kleinem Trick geht es trotzdem: Legen Sie vom Desktop aus in
  130.     dem bewußten Verzeichnis einen Ordner an und löschen Sie ihn gleich wie-
  131.     der. GEMDOS gibt einen einmal allocierten Directorycluster nämlich nicht
  132.     wieder frei.
  133.  4. Im Zielverzeichnis darf kein Objekt mit gleichem Namen bereits vorhanden
  134.     sein.
  135.  5. Volume label können nicht in einen Ordner verschoben werden.
  136.  
  137.  Alle diese Einschränkungen werden vom Programm überwacht. In solch einem
  138.  Fall läßt sich der Directoryeintrag nicht selektieren.
  139.  
  140.  Achtung !
  141.  Nach dem Umbenennen oder Verschieben von Ordnern und Dateien auf der Fest-
  142.  platte sollten Sie das System neu starten, da sonst GEMDOS die neuen Verzeich-
  143.  nisse nicht einliest ( Ein Medienwechsel ist ja bei der Festplatte nicht
  144.  vorgesehen ), und demzufolge auch nicht findet.
  145.  
  146.  
  147.  Einige Programm-Funktionen sind über die Tastatur zu erreichen :
  148.  
  149.    Esc   - Erneutes Einlesen des Wurzelverzeichnisses.
  150.  
  151.    a, b, ...  - Diese Tasten haben eine Doppelfunktion:
  152.  
  153.            1. Handelt es sich um die Laufwerksbezeichnung des gerade nicht
  154.               angezeigten Laufwerkes, so erfolgt ein Laufwerkswechsel.
  155.               Das Wurzelverzeichnis des gewünschten Laufwerkes wird
  156.               eingelesen.
  157.  
  158.            2. Handelt es sich um die Bezeichnung des gerade angezeigten
  159.               Laufwerkes, so wird das obere Fenster in das zweite kopiert
  160.               und dieses an die oberste Position gebracht.
  161.               War nur ein Fenster geöffnet, so wird ein zweites mit dem
  162.               Inhalt des ersten eröffnet.
  163.  
  164.    q     - Schließen der Fenster und Beenden des Programms.
  165.  
  166.  
  167.  
  168.  Bei Anwendung des Programms als Accessory ist folgendes zu beachten:
  169.  
  170.    Wenn das Accessory-Fenster vollständig durch ein anderes Fenster verdeckt
  171.    wird, reicht ein erneutes Anklicken des Menüeintrages, um das Fenster an
  172.    die oberste Position zu bringen.
  173.  
  174.    Bei aktiviertem Accessory sollte auf keinen Fall die laufende Applikation
  175.    abgebrochen bzw. eine neue gestartet werden. ( Denn zumindest beim TOS vom
  176.    6.2.86 kommt die AC_CLOSE-Meldung nicht rechtzeitig beim Accessory an. )
  177.    Im Klartext heißt das z.B.:
  178.    Bei geöffnetem Accessory-Fenster auf dem Desktop - kein Programm starten,
  179.    sondern erst das ( die ) Fenster schließen.
  180.  
  181.